home *** CD-ROM | disk | FTP | other *** search
/ BCI NET / BCI NET Dec 94.iso / archives / utilities / disk / gdu1_1.lha / GDu / GDu.man < prev    next >
Encoding:
Text File  |  1994-10-27  |  3.3 KB  |  102 lines
  1. NAME
  2.     GDu - graphically display disk usage (Version 1.1)
  3.  
  4. SYNOPSIS
  5.     GDu [-quiet] [-links] [-num]
  6.         [-window x y w h] [-fg num] [-bg num] [dir]
  7.  
  8. DESCRIPTION
  9.     GDu is a program for displaying a  graphical  tree  of  disk
  10.     space utilization,  similar to  the UN*X utilities  "du" and
  11.     "xdu". The user can navigate through the tree structure. The
  12.     window is divided up into several columns,  each of which is
  13.     one level deeper  in  the directory hierarchy  (from left to
  14.     right).  Boxes are drawn for each directory.   The amount of
  15.     vertical space occupied by each box is directly proportional
  16.     to  the amount of disk space  consumed by it  and all of its
  17.     children.  The name of each directory and the amount of data
  18.     are displayed provided that there is enough space within its
  19.     box.   Any space at the "bottom" of a box not covered by its
  20.     children to the right represents the space consumed by files
  21.     in that directory (as opposed to space from its children).
  22.  
  23.     There  are  some  command line options  available  if GDu is
  24.     started from the shell.
  25.  
  26.     -quit or -q    don't display filenames while scanning the
  27.             directory tree.
  28.  
  29.     -links or -l    follow links and include them in the tree
  30.  
  31.     -num or -n    sort display numerically (largest first)
  32.             default is to sort alphabetically
  33.  
  34.     -window x y w h  or  -w x y w h
  35.             determines position and size  of the window.
  36.             To use the system default for a value, enter
  37.             something non-numeric, e.g. "NaN".
  38.  
  39.     -fg color    determines the color of the text and lines.
  40.  
  41.     -bg color    determines the color of the background.
  42.  
  43.     If the program is started from  the  Workbench  or  no  root
  44.     directory is given,  a file requester  opens,  allowing  the
  45.     user to choose a root directory.
  46.  
  47. MOUSE ACTIONS
  48.     The user can move up or down the tree by clicking  the  left
  49.     mouse on a directory box.  If the left most box is selected,
  50.     the display will move up one level  (assuming  you  are  not
  51.     already at the root).  If any other box is selected, it will
  52.     be placed against the  left  edge  of  the  window  and  the
  53.     display  will be rescaled  appropriately.   If the window is
  54.     resized, the display will be rescaled. Clicking on the Close
  55.     gadget will exit the program.
  56.  
  57. KEYSTROKES
  58.     Several keystroke commands are supported.
  59.  
  60.     Cursor up     goto the previous directory on the same level.
  61.  
  62.     Cursor down    goto the next directory on the same level.
  63.  
  64.     Cursor right    goto the first subdirectory.
  65.  
  66.     Cursor left    go up one level (if not already at the root)
  67.  
  68.     BackSpace
  69.     or / (usa-keymap, this is the key left of right shift)
  70.             goto the root.
  71.  
  72.     Escape or q    exit the program.
  73.  
  74. EXAMPLE
  75.     GDu -quiet -window 2 11 640 468 RAM:
  76.  
  77. CHANGES
  78.     Version 1.1:
  79.     - now frees all its allocated memory (bug reported by Roland
  80.       Vosseler).
  81.     - options -num, -links
  82.     - requester if no directory given
  83.     - now possible to start from Workbench
  84.     - Control-C aborts without displaying a truncated tree.
  85.  
  86. TO DO
  87.     - keys for re-sorting the display
  88.     - Tool Types for Workbench start
  89.     - suggestions from You?
  90.  
  91. DISTRIBUTION
  92.     This program is free software;  you can redistribute it and/
  93.     or modify it  under  the  terms  of  the  GNU General Public
  94.     License as published by the Free Software Foundation.
  95.  
  96. AUTHOR
  97.     Rainer Köhler <koehler@mpia-hd.mpg.de>
  98.     Snail Mail:
  99.     Rainer Köhler, Hardtstraße 7, 69207 Sandhausen, Germany
  100.  
  101.     inspired by the UN*X utility "xdu" by Phillip C. Dykstra
  102.